Skip to content

docs: reorganize Specifications tab by topic, consolidate bridging sections - #1866

Merged
mindapivessa merged 3 commits into
masterfrom
docs/bridging-specs
Aug 28, 2026
Merged

docs: reorganize Specifications tab by topic, consolidate bridging sections#1866
mindapivessa merged 3 commits into
masterfrom
docs/bridging-specs

Conversation

@mindapivessa

Copy link
Copy Markdown
Collaborator

Summary

  • Replaces Core Primitives / Network Systems with topic-based groups in the Specifications tab. Developers navigate by subject (Bridging, Transactions, etc.) instead of by abstraction level, eliminating duplicate sidebar groups.
  • Consolidates two Bridging sections into one group with a clear ordering: Standard Bridges → Deposits → Withdrawals → Cross-Domain Messengers → Base-Solana Bridge.
  • Dissolves bridging-and-withdrawals.mdx — its accessible intro content was redistributed into the spec pages (deposits.mdx, withdrawals.mdx, bridges.mdx) so each page stands on its own.
  • Moves ecosystem bridges route picker from Specifications to Get Started → Quickstart (user-facing, not a spec).
  • Updates overview page cards to match the new topic-based groups.
  • Updates IA guidelines and content guidelines to reflect the new structure and decision rationale.

Test plan

  • Run mintlify dev and verify all Specifications pages render correctly
  • Confirm sidebar groups appear in the intended order with no duplicates
  • Verify the redirect from bridging-and-withdrawalswithdrawals works
  • Check that ecosystem bridges appears under Get Started → Quickstart
  • Run /lint and confirm no errors

🤖 Generated with Claude Code

…ctions

Replace Core Primitives and Network Systems with topic-based groups
(B20, Bridging, Transactions, Flashblocks, Consensus, Execution, Proofs)
so developers navigate by subject instead of abstraction level.

Consolidate the two duplicate Bridging groups into one. Dissolve the
bridging-and-withdrawals overview page, moving its content into the
deposits and withdrawals spec pages as accessible intro sections.
Move ecosystem bridges route picker to Get Started → Quickstart.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@mintlify

mintlify Bot commented Aug 28, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
base 🟢 Ready View Preview Aug 28, 2026, 8:52 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@cb-heimdall

cb-heimdall commented Aug 28, 2026

Copy link
Copy Markdown
Collaborator

✅ Heimdall Review Status

Requirement Status More Info
Reviews 1/1
Denominator calculation
Show calculation
1 if user is bot 0
1 if user is external 0
2 if repo is sensitive 0
From .codeflow.yml 1
Additional review requirements
Show calculation
Max 0
0
From CODEOWNERS 0
Global minimum 0
Max 1
1
1 if commit is unverified 0
Sum 1

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Add orphan pages to .mintignore and update old redirects to point
directly to final destinations instead of through intermediate pages.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@mindapivessa
mindapivessa merged commit ba8b6b5 into master Aug 28, 2026
9 checks passed
@mindapivessa
mindapivessa deleted the docs/bridging-specs branch August 28, 2026 21:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants